🧠 Vectorize MCP Worker

Hybrid RAG · Metadata Filtering · Multimodal Vision · Cloudflare Edge

Query Your Knowledge

🧭 Debug: Test Intent Routing

🎯 Try Demo Features

Explore hybrid retrieval, metadata filtering, and multimodal results with one click

📄 Ingest Document

or paste text

📸 Ingest Image

🔎 Find Similar Images

Upload an image to find visually similar ones already in your knowledge base.

🗑️ Delete Document

Permanently removes a document and all its chunks from the index and database.

📊 Index Stats

Live on Cloudflare Edge  •  Metadata filtering enabled
—
Vectors
—
Documents
—
Dimensions

🔎 Query Analytics

—
—
Avg latency (ms)
—
Cache hit rate
—
Total queries
Recent queries (last 10)
No queries yet — run a search to see analytics.

💰 Cost Calculator

Monthly Cost Projection
Click “Calculate” to see projection

🔑 Authentication

🚀 Intelligent Routing (V4)

🤖 AI Models

📋 License Management

✅ Setup Status

?
API Key
Click “Run Check” to verify
?
Vectorize Index
Click “Run Check” to verify
?
D1 Database
Click “Run Check” to verify
?
Workers AI Binding
Click “Run Check” to verify

🔧 Setup Your Own Instance

1
Clone the repository
git clone https://github.com/dannwaneri/vectorize-mcp-worker.git cd vectorize-mcp-worker npm install
2
Create Cloudflare resources
# Create Vectorize index (384d for default model) wrangler vectorize create mcp-knowledge-base --dimensions=384 --metric=cosine # Create D1 database wrangler d1 create mcp-knowledge-db
Copy the database_id from the D1 output and paste it into your wrangler.toml.
3
Run database migrations
wrangler d1 execute mcp-knowledge-db --file=./schema.sql
4
Set your API key secret
wrangler secret put API_KEY # Enter a strong random key when prompted # Generate one: node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"
5
Deploy
wrangler deploy
Your worker will be live at https://<worker-name>.<subdomain>.workers.dev
6
First ingest & search
1. Go to Ingest → paste any text into the Document form → click Ingest Document
2. Go to Search → ask a question about the text → results appear below

👥 Connect via MCP (Claude Desktop / Cursor)

Add this to your Claude Desktop or Cursor MCP config to use this worker as a knowledge tool.

{ "mcpServers": { "vectorize": { "command": "npx", "args": [ "mcp-remote", "https://<your-worker>.workers.dev/mcp", "--header", "Authorization: Bearer YOUR_API_KEY" ] } } }
Replace <your-worker> with your actual worker subdomain and YOUR_API_KEY with the secret you set in step 4.

🔗 Links

🔗 GitHub Repository 📄 Changelog 🐞 Report an Issue ☁️ Cloudflare Vectorize Docs

🗑️ Delete Document

This will permanently remove and all its chunks from the index. This cannot be undone.

⚡ Powered by Cloudflare Workers + Vectorize + D1 + Llama 4 Scout Vision